Description

This PR updates the versions of the software:

• Hugo from 0.141.0 to 0.152.2 (latest supported by Blowfish v2.86.0)
• Blowfish theme
  • Fast-forwarded from
    • Version: v2.86.0
    • Commit ID: 0b06a64139beba6287e7685f4c810ad4ff772fde
    • Timestamp: Tue May 27 01:03:33 2025 +0100
  • Fast-forwarded to
    • Version: v2.92.0
    • Commit ID: 81f0e887100f4ddc9856c6d662883b62ab7b1043
    • Timestamp: Mon Nov 3 22:34:25 2025 +0000

Background information

As you might know, the espressif/blowfish repo is added to our developer-portal repo as a submodule in the folder themes/blowfish/. Over time, we copied a few Blowfish layout files from themes/blowfish/layouts/ to layouts/ and applied some changes. Comparing the files in themes/blowfish/layouts/ with our overridden versions in layouts/ revealed considerable updates in the former (submodule).

We usually fast-forward the Blowfish submodule changes once in a few months and only incorporate the upstream changes from themes/blowfish/layouts/ into respective overridden files if the website fails to build or if we discover critical issues. One of such issues was non-functioning burger menu button fixed in PR #362.

Although, skipping incorporation of non-critical upstream changes saves our time, it leads to accumulating maintenance debt. Ideally, we need to incorporate the upstream changes to our overriden files at least once a year.

I decided to partially incorporate the upstream changes as this will help us better prepare for implementing our own updates planned for the near future, such as adding the Dark theme and improving the main page.

This time, I did the following:

• Extracted our changes by comparing the layouts/ files with their repective copies in themes/blowfish/layouts/ at the time of applying these changes
• Applied the extracted changes to the layout files in Blowfish: v2.92.0. This task usually requires considerable efforts in figuring out how to implement the changes as simple copying and pasting is usually not possible.

As a result, the following files have been updated so far:

• layouts/partials/article-link/card-related.html
• layouts/partials/article-link/card.html
• layouts/partials/footer.html
• layouts/partials/head.html
• layouts/partials/header/basic.html

With these updates, the website builds stably. No major bugs have been identified so far.

As of now, the following files are yet to be updated:

• layouts/partials/hero/basic.html
• layouts/partials/toc.html
• layouts/_default/baseof.html
• layouts/_default/single.html

Related

Testing

Checklist

Before submitting a Pull Request, please ensure the following:

• 🚨 This PR does not introduce breaking changes.
• All CI checks (GH Actions) pass.
• Documentation is updated as needed.
• Tests are updated or added as necessary.
• Code is well-commented, especially in complex areas.
• Git history is clean — commits are squashed to the minimum necessary.